Skip to content

docs(new-repo): adopting a pre-populated directory + the branding-name exception - #36

Merged
PBNZ merged 2 commits into
mainfrom
docs/33-adopt-existing-dir-and-branding
Aug 13, 2026
Merged

docs(new-repo): adopting a pre-populated directory + the branding-name exception#36
PBNZ merged 2 commits into
mainfrom
docs/33-adopt-existing-dir-and-branding

Conversation

@PBNZ

@PBNZ PBNZ commented Aug 13, 2026

Copy link
Copy Markdown
Owner

What & why

Two documentation gaps a scaffolding session had to improvise around. The skill now documents scaffolding into a directory that already has content — inventory first (an existing .git means retrofit, not scaffold), pre-existing content wins collisions, two commits with the import before the scaffold so the RepoKit diff stays pure, recorded in ADR-0001. And the kebab-case default now states its exception: a deliberate branding name is the user's choice, accepted and recorded in ADR-0001 — stated in the standard's naming conventions, the interview inputs, and the placeholder reference.

Refs #33

Checklist

  • One concern per PR (split unrelated changes).
  • Driving issue referenced as Refs #NN (no auto-close keywords), if the repo tracks issues.
  • Conventional Commit title (e.g. feat: …, fix: …, docs: …).
  • CHANGELOG.md updated under ## [Unreleased] if user-visible.
  • Validation passes locally (python scripts/*.py; see .github/workflows/validate.yml).
  • An ADR added under docs/adr/ for any notable decision — none here: documents field-proven practice, rationale stated inline.

🤖 Generated with Claude Code

https://claude.ai/code/session_013g4xpqBjwwzfqtKyEHuWUr

PBNZ and others added 2 commits August 13, 2026 19:33
…e exception (refs #33)

Two gaps a scaffolding session had to improvise around. The skill now
documents scaffolding into a directory that already has content:
inventory first (an existing .git means retrofit, not scaffold),
pre-existing content wins collisions, and two commits with the import
before the scaffold so the RepoKit diff stays pure. And the kebab-case
default now states its exception: a deliberate branding name is the
user's choice, accepted and recorded in ADR-0001 - stated in the
standard's naming conventions, the interview inputs, and the
placeholder reference.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_013g4xpqBjwwzfqtKyEHuWUr
@PBNZ
PBNZ merged commit 8d1d64f into main Aug 13, 2026
@PBNZ
PBNZ deleted the docs/33-adopt-existing-dir-and-branding branch August 13, 2026 08:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant